SetAxisPositionOffset

使用相同值操控轴的设定点位置和实际位置来移动轴的坐标系统，而不会导致任何移动（使用相同的跟随误差重新校正），此可在参考情况用作实例。

语法

KsCommandStatus SetAxisPositionOffset(
     int Index,
     double Position,
     BOOL Relative,
     McExecutionMode ExecutionMode
);

参数

Index [in]：轴索引。索引以零为起点；别名将影响此参数。

Position [in]：位置单位（若 Relative 为 TRUE 则为距离单位）。

Relative [in]：若为相对距离，设 TRUE；若为绝对距离设 FALSE，预设为 FALSE。

ExecutionMode [in]：定义函式的时间顺序，请见 McExecutionMode 类型。

回传值

返回 KsCommandStatus 结构。

备注

此函式仅适用于停止(Standstill) 或停用 (Disabled) 状态。
Relative 表示在执行时加入 Position（距离单位）至轴的实际位置，目标位置的结果将为实际位置＋距离，例如，实际位置为 50、距离为 100，则目标位置将为 150；"Absolute" 表示轴的实际位置为 Position 参数内指定的值。
当模数轴启用时，Absolute 模式的输入值将被转换为模数位置；而 Relative 模式的输入值则被用作距离，而非模数位置。

范例

复制

KsCommandStatus offsetCommand = WaitForCommand(10, TRUE,
   SetAxisPositionOffset(0, 0, FALSE, McExecutionMode::mcQueued));

使用需求

参见